home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / standards / sgml / monk < prev    next >
Encoding:
Text File  |  1993-07-15  |  3.5 KB  |  74 lines
  1. (Message net/comp/misc:7596)
  2. Xref: math.lsa.umich.edu comp.misc:7596 comp.text:5144
  3. Path: math.lsa.umich.edu!zaphod.mps.ohio-state.edu!mips!pacbell.com!pacbell!att!dptg!ulysses!andante!alice!eowyn
  4. From: eowyn@alice.UUCP (sharon murrel)
  5. Newsgroups: comp.misc,comp.text
  6. Subject: Re: What's the Monk document compiler?
  7. Summary: monk uses a stylesheet to generate troff
  8. Keywords: monk, troff
  9. Message-ID: <11121@alice.UUCP>
  10. Date: 2 Aug 90 07:58:01 GMT
  11. References: <1990Jul25.133427.5549@tsa.co.uk>
  12. Reply-To: eowyn@alice.UUCP (mh7173)
  13. Followup-To: comp.text
  14. Organization: AT&T, Bell Labs
  15. Lines: 58
  16.  
  17. In article <1990Jul25.133427.5549@tsa.co.uk> domo@tsa.co.uk (Dominic Dunlop)
  18. writes in comp.misc:
  19.  
  20. >So what's the Monk document compiler?  Does it bear any relationship to the
  21. >?roff that we know and rub along with?  To SGML?  To anything at all?
  22.  
  23. Dominic missed the inside cover of the first issue produced in-house:
  24.  
  25. AT&T Technical Journal, vol. 68, no. 4 (July/August, 1989):
  26.     
  27.   Beginning with this issue of the AT&T Technical Journal, all papers will
  28.   have been formatted electronically by Monk, a document compiler for the
  29.   UNIX system developed at AT&T Bell Laboratories in Murray Hill, New Jersey.
  30.  
  31. This issue of the AT&T Technical Journal consists entirely of papers on
  32. electronic publishing and includes an article on monk. The article, as well
  33. as the monk system and the paper in the tenth edition manual, are written
  34. by myself, Sharon Murrel, and Ted Kowalski.
  35.  
  36. Monk provides a English-like interface for authors
  37.  
  38.     |begin(abstract)This is a |bold(great) paper.|end(abstract)
  39.  
  40. and more importantly a database language for writing stylesheets.
  41.  
  42. Monk translates commands that appear in the author's text into troff commands
  43. by consulting the style databases. These databases provide precise typographical
  44. information that layout designers create for headers, footers, sections, figures,
  45. abstracts, references, cover sheets, table of contents, and more. The document
  46. stylesheets contain no raw troff, but rather use a set of primitives. Another
  47. database provides the troff implementation of the set of primitives. Monk
  48. automatically restores the values of stacking primitives (like indent and
  49. font) upon exiting a region like the abstract above. Its database language provides
  50. some programming capabilities, like loops and conditionals, and primitive string
  51. handling to keep whitespace under control and zap auxiliary text like footnotes
  52. where text is being reused in headers and table of contents.
  53.  
  54. It is related to SGML in that it tries to introduce a set of tagging nouns.
  55. It is intended to minimize the need for raw troff, but it does nothing to prevent
  56. the inclusion of raw troff. Furthermore, it goes to some effort to assure that the
  57. order of tags is not important. It does not define a hierarchy of tags nor does
  58. it require any specific tags or ordering of tags as must the document description
  59. required by SGML. Monk documents are in general more easily translated into an SGML
  60. compliant form than their macro brethren, but this depends upon consistent use of
  61. the tags by authors.
  62.  
  63. Monk is currently being used in some efforts to standardize the look of AT&T
  64. documentation. It provides a nice platform for defining new document styles.
  65. It is not yet released, but keep hoping.
  66.  
  67. The paper in the tenth edition manual is really a user guide. The paper in the
  68. AT&T Technical Journal spends more words providing an overview and describing
  69. the stylesheet databases. If you would like a copy of these papers, please
  70. send mail to eowyn@research.att.com. I changed the follow up to comp.text rather
  71. than comp.misc.
  72.  
  73.                         - sharon
  74.